Trac is being migrated to new services! Issues can be found in our new YouTrack instance and WIKI pages can be found on our website.

Version 22 (modified by sadrul, 17 years ago) (diff)

someone should correct the grammar here

Using Finch

Getting around

Abbreviations

M-<chr> means hold the META or EDIT or ALT key down while typing <chr>. If there is no META, EDIT or ALT key, instead press and release the ESC key and then type <chr>.

How do I switch between windows?

You can press M-n/M-p to go to the next/previous window, or M-N where N is 1-9. You can also press M-w to bring out a list of all the windows. In the window list, you can select a row and press return to go to that window.

How can I close a window?

Press M-c.

How can I show a window's menu?

The default key-binding is F10. Note that not all windows have a menu.

How can I pop up a widget's context menu?

The default key-binding is F11.

Can I change the bindings? How?

Yes! For details on how to do this, read 'man finch'. Here's a small example to show how to rebind alt+ctrl+n to switch to the next window: In ~/.gntrc, add

[GntWM::binding]
c-a-n = window-next

Note that, the default binding alt+n will continue to switch to the next window. If you want to unbind that, add

[GntWM::binding]
a-c-n = window-next
a-n=

To see the list of available rebindable actions for the focused widget, press "alt+/".

How can I enable the mouse?

In ~/.gntrc, set mouse = 1 under [general]. If you use screen, read more.

If I enable the mouse, I cannot select text from the terminal any more.

When the mouse is enabled, hold shift to use your terminal's mouse selecting.

My arrow keys are not working. What can I do?

Make sure there is a correct terminfo setting for your terminal. For example, try setting $TERM to "screen" instead of "screen.linux".

How do I see the parts of a large window that fall below the screen?

Press M+ctrl+j to scroll down, and M+ctrl+k to scroll up.

Is there anything else I change in ~/.gntrc?

In 'man finch', look at the 'general', 'colors' and 'colorgroups' sections in the sample ~/.gntrc.

Buddy List

How can I add a buddy, or a chat, or a group?

  • Select a group in the buddylist.
  • Press F11 to bring out the context menu. Select "Add Buddy" or "Add Chat".

How can I auto-join a chat?

  • Select the chat in the buddylist.
  • Bring out the context menu. Select 'Auto-join'.

How can I expand/collapse contacts?

  • Select the contact and press Space.

How can I move buddies/chats into another group?

  • Select the buddy/chat you want to move in the buddylist.
  • Press 't' to tag the buddy/chat. You can tag more than one buddy/chat at the same time if you want.
  • Select the buddy/group you want to move the tagged buddies to.
  • Press 'a' to attach. The buddies will be attached to the selected contact. The chats will be attached to the current group.

How can I show offline buddies?

  • In the buddylist, press F10 to bring up the menu.
  • Select 'Options' | 'Toggle offline buddies'

I closed the buddylist. Can I get it back again?

Yes! Press M-a to bring out the actions menu, select 'Buddy List'.

Conversations

In chats, can I see the list of users in the chatroom?

Yes. Use the /users command. (after 2.0.0. Until then, press tab and all the users will be presented in the tab-completion dropdown)

In a conversation with a contact, can I select which buddy the message is sent to?

Yes. Bring out the menu for the conversation window. Select the buddy from the 'Send To' menu. (after 2.0.0)

Can I select multi-line texts/urls from a conversation window?

Yes. First, enable the mouse. Then click+drag the mouse to select the text. This will copy the selected text into the internal clipboard. You can then press alt+shift+c, which will show the text from the internal clipboard at the top of the screen. You can then select the text using your terminal's mouse selecting. Press M+shift+c to close the clipboard container.

Others

Is there a pounce/debug/file-transfer/preference/plugins/status window?

Yes! Press M-a to bring out the actions menu. Select the window you want to see.

How do I get the mouse working in screen?

You can do a bunch of things with the mouse in finch (after putting "mouse = 1" in ~/.gntrc), including selecting text over multiple lines in conversation windows, which is hard to do with the mouse selection in your terminal - so having the mouse enabled in finch can be advantageous. For at least a few people, screen is missing the kmous capability entry in its terminfo. Here's how to add it:

From the terminal in which you run screen, and while not in screen:

infocmp | sed -n 's/.*\(kmous=[^,]\+\).*/\1/p'

(from what I've read, for this to work in ncurses, the value "must" be "\E[M"?) Within screen:

infocmp > tmp

Open tmp and add the kmous entry from above, save and close and do:

tic tmp

In screen, when I press esc, there is a huge delay, how can this be reduced?

Finch adds its own small delay after pressing esc, to allow pressing esc then <whatever> in quick succession for alt-X shortcuts where your alt key may be missing. Screen also does this, so to avoid having both applications add the delay: maptimeout 0 into ~/.screenrc Alternatively, type C-a :maptimeout 0 while in screen.

All information, including names and email addresses, entered onto this website or sent to mailing lists affiliated with this website will be public. Do not post confidential information, especially passwords!